home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Mops 2.5 / README.1ST < prev   
Encoding:
Text File  |  1994-11-05  |  7.3 KB  |  196 lines  |  [TEXT/MSET]
  1. This is Mops 2.5, of Oct/Nov 1994.
  2.  
  3. This package contains the full Mops system, but not the manual, which
  4. should be available from the same location you got this.  It should have
  5. a name something like Mops25m.sea.  It's a separate file because of size.
  6.  
  7. You will really need the manual if you're going to do anything with Mops.
  8. But if you already have the 2.4 manual, you can probably get by with just
  9. reading the Release Notes which are part of this package, since the Notes
  10. describe all the main changes from version 2.4.
  11.  
  12. This package contains the nucleus as an application, and all the source
  13. code.  The nucleus can't be used by itself, but you have to bootstrap
  14. the full system by running the nucleus and using it to compile up everything
  15. else from the source.  The reason for this procedure is to reduce the size 
  16. of the total package as much as possible - it's big enough already!
  17.  
  18. The instructions for compiling up the system are give below, and aren't
  19. hard (I hope).
  20.  
  21.  
  22.             ============================
  23.  
  24. You should have a folder called "Mops 2.5".  In this folder there should
  25. be two files and three folders.  The two files are this file (README.1ST)
  26. and "Mops 2.5 release notes".  The folders are "Mops ƒ", "Mops Source" and
  27. "Quick Edit ƒ".
  28.  
  29. The "release notes" file is mainly aimed at current Mops users, and
  30. describes the differences in this release, as well as possible future
  31. developments.
  32.  
  33. "Mops ƒ" contains:
  34.  
  35. *** The Mops application itself
  36.  
  37. *** The source files which get loaded above the nucleus, but before
  38. HFS file handling is available - Base, Args, Class, Struct, String, Files 
  39. and Modules.  These must be in the same folder as Mops.
  40.  
  41.  
  42. "Mops source" contains all the other Mops source files (of course!!)
  43.  
  44. The folder "More classes" contains various ex-Neon classes that I 
  45. have converted, as well as a number of other classes I have written over 
  46. the last few years.  Some of these have not been updated to the latest Mops 
  47. version, but only minor changes would be needed. There is some code there 
  48. which can read and write formatted Microsoft Word documents. I used to need
  49. this capability in my work. By the way, hacking out the MW document format
  50. for versions 1-4 was no joke!!  (Yes, the code will read "fast saved"
  51. documents.)  But I haven't added Word 5 support, and probably won't ever,
  52. since I've now changed over to Nisus (yes, this is now a Microsoft-free
  53. zone).
  54.  
  55. "Quick Edit ƒ" contains Doug Hoffman's Quick Edit text editor which
  56. communicates with Mops via Apple events, and related files.
  57.  
  58. If you don't alter the folder configuration as supplied, things should 
  59. work. If you want to put all the Mops stuff into a folder, or change the 
  60. folder configuration, you will need to edit the file "Mops.paths" in the 
  61. "Mops ƒ" folder - this defines the HFS paths that Mops will use to look for 
  62. files.
  63.  
  64.  
  65.                 ===============================
  66.                 
  67. Now, here are the instructions for compiling everything, to get you up
  68. and running.
  69.  
  70. First start up the nucleus application "Mops".  You should get a window
  71. appearing on the screen with no menus.  The window will be showing a
  72. message telling you that it is only the nucleus, and that you should now
  73. compile the system by typing
  74. load base <ENTER>
  75. and look at the Readme.1st file, or the intro chapter of the manual.
  76. That's exactly what you're doing—so far so good!
  77.  
  78. So go ahead and type
  79.  
  80. load base        (followed by the <ENTER> key)
  81.  
  82. This will do the first stage of the compilation.  Note that Mops commands
  83. are terminated by <ENTER>.
  84. .
  85. The compilation will take a couple of minutes.  If no errors come up, you'll
  86. get a message saying that interim.dic has been saved, and the ">" prompt
  87. again.
  88.  
  89. interim.dic is the partial dictionary that has just been compiled.  It will
  90. be in the "Mops ƒ" folder.
  91.  
  92. If something goes wrong in the next stages, you can get back to this point
  93. by double-clicking on interim.dic, without having to go back to the bare
  94. nucleus.
  95.  
  96. Now, to compile the rest of the dictionary, type
  97.  
  98. // sys.ld
  99.  
  100. and everything else should be compiled.  It only takes a couple of minutes
  101. on most Macs.  The names of the different files will appear on the screen
  102. as they are being compiled.  If everything goes OK, at the end of the
  103. compilation you'll get the following message, which should be
  104. self-explanatory:
  105.  
  106.   The Mops system is compiled.  Now save the dictionary, by typing e.g.
  107.   save Mops.dic
  108.   then type bye to quit, and after that you'll be able to fire up the
  109.   newly-compiled dictionary.
  110.  
  111. So do what it says—save the full dictionary by typing
  112.  
  113. save Mops.dic
  114.  
  115. In previous Mops versions, you could at this point start running the system.
  116. However we now have a new interface, and this needs to be initialized
  117. properly by being started up from the Finder.  So quit by typing
  118.  
  119. bye
  120.  
  121. Then after that, you can then fire up the "proper" Mops system by
  122. double-clicking on Mops.dic.
  123.  
  124. Finally, if you use floating point, you can compile it by firing up
  125. Mops.dic and typing
  126.  
  127. // floating point 
  128.  
  129. and when it's compiled, save with
  130.  
  131. save MopsFP.dic
  132.  
  133. After this, you should be able to fire up either the standard or
  134. floating point system by double-clicking on the dictionary image Mops.dic
  135. or MopsFP.dic.
  136.  
  137.  
  138.                 ================================
  139.  
  140. I assemble the nucleus source with Dave McWherter's shareware McAssembly. I
  141. gather it is reasonably compatible with other Mac assemblers. (Unfortunately,
  142. it doesn't work under System 7.)  So far nobody else has been brave enough
  143. to actually try reassembling the nucleus, as far as I'm aware.  If you find
  144. a bug, it's probably better to simply let me know.
  145.  
  146.  
  147.                 ================================
  148.  
  149.  
  150. Finally, please note that I am releasing all original Mops material into 
  151. the public domain.  If you want to use it commercially, that's fine, go
  152. right ahead, but I'd really appreciate it if you could let me know. In
  153. return I could let you know of any late-breaking bugs/fixes which may be
  154. very helpful to you.
  155.  
  156. I'd also like to know about any other Mops development that anyone feels 
  157. free to let me know about.  Even better, if you develop some whiz-bang new 
  158. class or whatever, you could send me a copy and I could make it part of the
  159. standard Mops release.  This has already occurred with significant code being
  160. contributed by Doug Hoffman, Greg Haverkamp and Xan Gregg.  As a one-man
  161. part-time effort, Mops can't hope to compete with the slick commercial
  162. products - but with a bit of cooperation from those using it, Mops could
  163. become a very useful development system, and the price is certainly right.
  164. (So is the performance, I think you'll find.)
  165.  
  166. If you have any queries, comments or (gasp!) bug reports, please send me
  167. an email message at one of the following:
  168.  
  169. internet:     mikeh@zeta.org.au
  170. CompuServe:   100033,3164
  171.  
  172. snail-mail:
  173.         Michael Hore
  174.         54 Frederick St,
  175.         Sydenham  NSW 2044,
  176.         AUSTRALIA.
  177.  
  178.  
  179. I also read the newsgroup comp.lang.forth and comp.lang.forth.mac, so you
  180. can post there and I'll see it, especially if you put "Mops" somewhere in
  181. the subject line.
  182.  
  183. There is now a Mops section in the Forth Forum on CompuServe (GO FORTH)
  184. - it's section 4.  I check there every couple of days if possible.
  185.  
  186. There was also a Mops topic on GEnie (Forth RoundTable, category 7,
  187. topic 40), but I guess this is now defunct, since I don't have access to
  188. GEnie any more, and probably won't in the foreseeable future.  So if you
  189. need to contact me, do it in one of the other ways.
  190.  
  191.  
  192. I hope you enjoy Mops.
  193.  
  194.  
  195. --  Mike Hore.
  196.